<!DOCTYPE html>
<html>
  <head>
    <meta name="creator" content="mantohtml v2.0.2">
    <title>lpoptions(1)</title>
  </head>
  <body>
    <h1 id="lpoptions-1">lpoptions(1)</h1>
    <h2 id="lpoptions-1.name">Name</h2>
<p>lpoptions - display or set per-user printer options and defaults
</p>
    <h2 id="lpoptions-1.synopsis">Synopsis</h2>
<p><strong>lpoptions</strong>
[
<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
]
<strong>-d </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
[
<strong>-l</strong>
]
<br>
<strong>lpoptions</strong>
[
<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
] [
<strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
]
<strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>] ...
<br>
<strong>lpoptions</strong>
[
<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
] [
<strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
]
<strong>-r</strong>
<em>option</em>
<br>
<strong>lpoptions</strong>
[
<strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
]
<strong>-x </strong><em>destination</em>[<strong>/</strong><em>instance</em>]
</p>
    <h2 id="lpoptions-1.description">Description</h2>
<p><strong>lpoptions</strong> displays or sets printer options and defaults.
If no printer is specified using the <em>-p</em> option, the default printer is used as described in
<a href="lp.html"><strong>lp</strong>(1).</a>

</p>
    <p>If no <em>-l</em>, <em>-o</em>, or <em>-r</em> options are specified, the current options are reported on the standard output.
</p>
    <p>Options set with the <strong>lpoptions</strong> command are used by the
<a href="lp.html"><strong>lp</strong>(1)</a>

and
<a href="lpr.html"><strong>lpr</strong>(1)</a>

commands when submitting jobs.
</p>
    <p>When run by the root user, <strong>lpoptions</strong> gets and sets default options and instances for all users in the <em>/etc/cups/lpoptions</em> file.
Otherwise, the per-user defaults are managed in the <em>~/.cups/lpoptions</em> file.
</p>
    <h2 id="lpoptions-1.options">Options</h2>
<p><strong>lpoptions</strong> supports the following options:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
Enables encryption when communicating with the CUPS server.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
Sets the user default printer to <em>destination</em>.
If <em>instance</em> is supplied then that particular instance is used.
This option overrides the system default printer for the current user.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
Uses an alternate server.
Note: This option must occur before all others.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
Lists the printer specific options and their current settings.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>option</em>[<strong>=</strong><em>value</em>]<br>
Specifies a new option for the named destination.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
Sets the destination and instance, if specified, for any options that follow.
If the named instance does not exist then it is created.
Destinations can only be created using the
<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>

program.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>option</em><br>
Removes the specified option from the named destination.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-x </strong><em>destination</em>[<strong>/</strong><em>instance</em>]<br>
Removes the options for the named destination and instance, if specified.
If the named instance does not exist then this does nothing.
Destinations can only be removed using the
<a href="lpadmin.html"><strong>lpadmin</strong>(8)</a>

command.
</p>
    <h2 id="lpoptions-1.environment">Environment</h2>
<p>The following environment variables override the default destination:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
Specifies the default print queue (System V standard).
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
Specifies the default print queue (Berkeley standard).
</p>
    <h2 id="lpoptions-1.files">Files</h2>
<p><em>~/.cups/lpoptions</em> - user defaults and instances created by non-root users.
<br>
<em>/etc/cups/lpoptions</em> - system-wide defaults and instances created by the root user.
</p>
    <h2 id="lpoptions-1.conforming-to">Conforming To</h2>
<p>The <strong>lpoptions</strong> command is unique to CUPS.
</p>
    <h2 id="lpoptions-1.see-also">See Also</h2>
<a href="cancel.html"><p><strong>cancel</strong>(1),</a>

<a href="lp.html"><strong>lp</strong>(1),</a>

<a href="lpadmin.html"><strong>lpadmin</strong>(8),</a>

<a href="lpr.html"><strong>lpr</strong>(1),</a>

<a href="lprm.html"><strong>lprm</strong>(1),</a>

CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
    <h2 id="lpoptions-1.copyright">Copyright</h2>
<p>Copyright &copy; 2020-2024 by OpenPrinting.
  </body>
</html>
